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Ex Reference Manual® 


The ex editorf is a line oriénted text editor, which supports both command and display oriented 
editing. This reference manual describes the command oriented part of ex. 


Copyright 1979, 1980, 1982 Regents of the University of California, reprinted by permissi6n. 


The vi(ex) editor is based on software developed by The University of California, Berkeley, California, Computer Science 


Division, Department of Electrical Engineering and Computer Science, and such software is owned and licensed by the 
Regents of the University of California. 


1. Starting the ex Editor 


When invoked, ex determines the terminal type from the TERM variable in the environment. If 
there is a TERMCAP variable in the environment and the type of the terminal described there 
matches the TERM variable, then that description is used. Also if the TERMCAP variable contains a 
pathname (beginning with a /) then the editor will seek the description of the terminal in that file 
(rather than the default /etc/termcap). If there is a variable EXINIT in the environment then the 
editor will execute the commands in that variable; otherwise, if there is a file .exrc in your HOME 
directory ex reads commands from that file, simulating a source command. Option setting 
commands placed in EXINIT or .exrc will be executed before each editor session. 


A command to enter ex has the following prototype.’ 
ex [-I[-vll-t cagi{-rl{-U[-wall-xJ[-RI[ +commandl name... 
The most common case edits a single file with no options, 1.e.: 
ex name 


The - command line option suppresses all interactive-user feedback and is useful in processing 
editor scripts in command files. 


e The -v option is equivalent to using vi rather than ex. 


e The -t option is equivalent to an initial tag command, editing the file containing the tag and 
positioning the editor at its definition. 


e The -r option is used in recovering after an editor or system crash, retrieving the last saved 
version of the named file or, if no file is specified, typing a list of saved files. 


e The -l option sets up for editing LISP, setting the showmatch and lisp options. 


e The -w option sets the default window size to nm, and is useful on dial-ups to start in small 
windows. 


e The -x option causes ex to prompt for a key, which is used to encrypt and decrypt the contents 
of the file, which should already be encrypted using the same key, see crypt(1). 


e The -R option sets the readonly option at the start.” 
e The mame arguments indicate files to be edited. 


e An argument of the form +command indicates that the editor should begin by executing the 
specified command. If command is omitted, then it defaults to "$", positioning the editor at the 
last line of the first file initially. Other useful commands here are scanning patterns of the form 
"/pat” or line numbers, e.g., “+100” starting at line 100. 


2. File Manipulation 
2.1 Current File 


The ex editor is normally editing the contents of a single file, whose name is recorded in the 
current file name. The ex editor performs all editing actions in a buffer (a temporary file) into 
which the text of the file is initially read. Changes made to the buffer have no effect on the file 
being edited until the buffer contents are written out to the file with a write command. After the 
buffer contents are written, the previous contents of the written file are no longer accessible. When 
‘a file is edited, its name becomes the current file name and its contents are read into the buffer. 


1. Brackets ({]) surround optional parameters. 
2. Not available in all V2 editors due to memory constraints. 


The current file is almost always considered to be edited. This means that the contents of the 
buffer are logically connected with the current file name, so that writing the current buffer contents 
onto that file, even if it exists, is a reasonable action. If the current file is not edited then ex will not 
normally write on it if it already exists. The file command will say “[Not edited]” if the current file 
is not considered edited. 


2.2 Alternate File 


Each time a new value is given to the current file name, the previous current file name is saved 
as the alternate file name. Similarly, if a file is mentioned but does not become the current file, it is 
saved as the alternate file name. 


2.3 Filename Expansion 


Filenames within the editor may be specified using the normal shell expansion conventions. In 
addition, the character °%’ in filenames is replaced by the current file name and the character "#’ by 
the alternate file name. This makes it easy to deal alternately with two files and eliminates the need 
for retyping the name supplied on an edit command after a No write since last change diagnostic 
message is received. 


2.4 Multiple Files and Named Buffers 


If more than one file is given on the command line, then the first file is edited as described 
above. The remaining arguments are placed with the first file in the argument list. The current 
argument list may be displayed with the args command. The next file in the argument list may be 
edited with the next command. The argument list may also be respecified by specifying a list of 
names to the next command. These names are expanded with the resulting list of names becoming 
the new argument list, and ex edits the first file on the list. 


For saving blocks of text while editing, and especially when editing more than one file, ex has a 
group of named buffers. These are similar to the normal buffer, except that only a limited number 
of operations are available on them. The buffers have names a through z. It is also possible to refer 
to A through Z; the upper case buffers are the same as the lower but commands append to named 
buffers rather than replacing if upper case names are used. 


2.5 Read-Only Mode 


It is possible to use ex in the read-only mode to look at files that you have no intention of 
modifying. This mode protects you from accidently overwriting the file. Read-only mode is on 
when the readonly option is set. It can be turned on with the -R command line option, by the view 
command line invocation, or be setting the readonly option. It can be cleared by setting the 
noreadonly mode. It is possible to write, even while in read-only mode, by indicating that you really 
know what you are doing. You can write to a different file, or use the ! form of write, even while in 
read-only mode. 


3. Exceptional Conditions 
3.1 Errors and Interrupts 


When errors occur ex (optionally) rings the terminal bell and prints an error diagnostic. If the 
primary input is from a file, editor processing will terminate. If an interrupt signal is received, ex 
prints "Interrupt" and returns to its command level. If the primary input is a file, then ex will exit 
when this occurs. 


3.2 Recovering From Hang-ups and Crashes 


If a hang-up signal is received and the buffer has been modified since it was last written, or if 
the system crashes, either the editor (in the first case) or the system (after it reboots in the second 
case) will attempt to preserve the buffer. The next time you log in you should be able to recover the 
work you were doing, losing at most a few lines of changes from the last point before the hang-up or 
editor crash. To recover a file you can use the -r option. If you were editing the file resume, then 


you should change to the directory where you were when the crash occurred, giving the command 
ex -r resume 
After checking that the retrieved file is good, you can write it over the previous contents of that file. 


You will normally get mail from the system telling you when a file has been saved after a crash. 
The command 


ex -F 


will print a list of the files which have been saved for you. In the case of a hang-up, the file will not 
appear in the list, although it can be recovered. 


4. Editing Modes 
The ex editor has five distinct modes. 


e The primary mode is the command mode. Commands are entered in command mode when a : 
prompt is present and are executed each time a complete line is sent. 


© In text input mode ex gathers input lines and places them in the file. The append, insert, and 
change commands use text input mode. No prompt is printed. This mode is left by typing a “*.” 
alone at the beginning of a line and command mode resumes. 


The last three modes are open mode, visual mode (entered by the commands of the same name), 
and text insertion mode (within open and visual modes). 


e The open mode allows local editing operations to be performed on the text in the file. The open 
command displays one line at a time and can be used on any terminal. 


e The visual mode allows local editing operations to be performed on the text in the file. The 
visual command works on CRT terminals with random positioning cursors, using the screen as a 
single window for file editing changes. 


These modes are described in sections 1 through 9. 


5. Command Structure 


Most command names are English words (initial prefixes of the words are acceptable 
abbreviations). The ambiguity of abbreviations is resolved in favor of the more commonly used 
commands. As an example, the substitute command can be abbreviated ‘“‘s”. The shortest available 
abbreviation for the set command is “se”. 


5.1 Command Parameters 


Most commands accept prefix addresses specifying the lines in the file upon which they are to 
have effect. The forms of these addresses will be discussed below. A number of commands also 
may take a trailing count specifying the number of lines to be involved in the command.’ Thus the 
10p command will print the tenth line in the buffer. The delete 5 command will delete five lines 
from the buffer, starting with the current line. 


Some commands take other information or parameters, the information always being given after 
the command name. Examples would be option names in a set command (set number), a file name 
in an edit command, a regular expression in a substitute command, or a target address for a copy 
command (1,5 copy 25). 


3. Counts are rounded down if necessary. 


5.2 Command Variants 


A number of commands have two distinct variants. The variant form of the command is invoked 
by placing an ! immediately after the command name. Some of the default variants may be 
controlled by options; in this case the ! serves to toggle the default. 


5.3. Flags After Commands 


The characters #, p and I may be placed after many commands.’ In this case, the command 
abbreviated by these characters is executed after the command completes. Since ex normally prints 
the new current line after each change, p is rarely necessary. Any number of + or - characters may 
also be given with these flags. If they appear, the specified offset is applied to the current line value 
before the printing command is executed. 


5.4 Comments 


It is possible to give editor commands which are ignored. This is useful when making complex 
editor scripts for which comments are desired. The comment character is the double quote ". Any 
command line beginning with " is ignored. Comments beginning with " may also be placed at the 
ends of commands, except in cases where they could be confused as part of the text (shell escapes 
and the substitute and map commands). 


5.5 Multiple Commands Per Line 


More than one command may be placed on a line by separating each pair of commands by a | 
character. However, the global commands, comments, and the shell escape ! must be the last 
command on a line, as they are not terminated by al, 


5.6 Reporting Large Changes 


Most commands which change the contents of the editor buffer give feedback if the scope of the 
change exceeds a threshold given by the report option. This feedback helps to detect undesirably 
large changes so that they may be quickly and easily reversed with an undo command. After 
commands with more global effect (such as global or visual), you will be informed if the net change 
in the number of lines in the buffer during this command exceeds this threshold. 


6. Command Addressing 


6.1 Addressing Primitives 


The current line. Most commands leave the current line as the last line which they affect. The 
default address for most commands is the current line, thus . is rarely used 
alone as an address. 


n The nth line in the editor buffer, lines being numbered sequentially from 1. 

$ The last line in the buffer. 

% An abbreviation for ‘“1,$”, the entire buffer. 

+n -n An offset relative to the current buffer line. The forms .+3, +3, and +++ 


are all equivalent; if the current line is line 100 they all address line 103. 


/pat/ ?pat? Scan forward and backward respectively for a line containing pat, a regular 
expression (as defined below). The scans normally wrap around the end of 
the buffer. If all that is desired is to print the next line containing pat, then 
the trailing / or ? may be omitted. If pat is omitted or explicitly empty, 


4. Ap or! must be preceded by a blank or tab except in the single special case dp. 


then the last regular expression specified is located.° 


x Before each non-relative motion of the current line ., the previous current 
line is marked with a tag, subsequently referred to as ”. This makes it easy 
to refer or return to this previous context. Marks may also be established by 
the mark command, using single lower case letters x and the marked lines 
referred to as ’x. 


6.2 Combining Addressing Primitives 


Addresses to commands consist of a series of addressing primitives, separated by , or ;. Such 
address lists are evaluated left-to-right. When addresses are separated by , the current line . is set 
to the value of the previous addressing expression before the next address is interpreted. If more 
addresses are given than the command requires, then all but the last one or two are ignored. If the 
command takes two addresses, the first addressed line must precede the second in the buffer. Null 
address specifications are permitted in a list of addresses, the default in this case is the current line 
(.); thus, ,100 is equivalent to .100. It is an error to give a prefix address to a command which 
expects none. 


7. Command Descriptions 
The following form is a prototype for all ex commands: 


address command ! parameters count flags 
P 


All parts are optional; the degenerate case is the empty command which prints the next line in the 
file. For sanity with use from within visual mode, the ex editor ignores a . preceding any command. 
In the following command descriptions, the default addresses are shown in parentheses. 


Note: The parentheses are not part of the command syntax. 


abbreviate word rhs abbr: ab 
Add the named abbreviation to the current list. When in the input mode in visual, if word is 
typed as a complete word, it will be changed to rhs. 


(.) append abbr: a 

text 
Reads the input text and places it after the specified line. After the command, . addresses the 
last line input or the specified line if no lines were input. If address 0 is given, text is placed 
at the beginning of the buffer. 


text 


The variant flag to append toggles the setting for the autoindent option during the input of 
text. 


args 
The members of the argument list are printed, with the current argument delimited by [ and ]. 


‘(.,.) change count abbr: ¢ 


5. The forms \/ and \? scan using the last regular expression used in a scan; after a substitute, // and 7? would scan using 
the substitute’s regular expression. 


text 


Replaces the specified lines with the input text. The current line becomes the last line input; 
if no lines were input it is left as for a delete. 


The variant toggles autoindent during the change. 


(.,.) copy addr flags abbr: co 
A copy of the specified lines is placed after addr, which may be 0. The current line . 
addresses the last line of the copy. The command t is a synonym for copy. 


(.,.) delete buffer count flags abbr: d 
Removes the specified lines from the buffer. The line after the last line deleted becomes the 
current line; if the lines deleted were originally at the end, the new last line becomes the 
current line. If a named buffer is specified by giving a letter, the specified lines are saved in 
that buffer or appended to it if an upper case letter is used. 


ex file abbr: e 

Used to begin an editing session on a new file. The editor first checks to see if the current 
buffer has been modified since the last write command was issued. If it has been, a warning is 
issued and the command is aborted. The command otherwise deletes the entire contents of the 
editor buffer, makes the named file the current file, and prints the new filename. After 
insuring that this file is not a binary file (such as a directory), a block or character special file 
(other than Adevéty), a terminal, or a binary or executable file (as indicated by the first word), 
the editor reads the file into its buffer. If the read of the file completes without error, the 
number of lines and characters read is typed. If there were any non-ASCII characters in the 
file they are stripped of their non-ASCII high bits, and any null characters in the file are 
discarded. If none of these errors occurred, the file is considered edited. If the trailing 
newline character is missing from the last line of the input file, it will be supplied and a 
complaint will be issued. This command leaves the current line (.) at the last line read. If 
executed from within open or visual mode, the current line is initially the first line of the file. 


e! file 
The variant form suppresses the complaint about modifications having been made and not 
written from the editor buffer, thus discarding all changes which have been made before 
editing the new file. 


e +n file 
Causes the editor to begin at line n rather than at the last line; m may also be an editor 
command containing no spaces, e.g., +/pat. 


file abbr: f 
Prints: 


the current file name 


whether it has been “modified” since the last write 
command 


whether it is read-only mode 
the current line 
the number of lines in the buffer 


the percentage of the way through the buffer of the 
current line. 


In the rare case that the current file is “not edited” this is noted also. In this case you have to 
use the form w! to write to the file, since the editor is not sure that a write command will not 
destroy a file unrelated to the current contents of the buffer. 


file file 


The current file name is changed to file which is considered “not edited”. 


(1,$) global /pat/emds abbr: g 


First marks each line among those specified which matches the given regular expression. Then 
the given command list is executed with . initially set to each marked line. 


The command list consists of the remaining commands on the current input line and may 
continue to multiple lines by ending all but the last such line with a \. If cmds (and possibly 
the trailing / delimiter) is omitted, each line matching pat is printed. The append, insert, and 
change commands and associated input are permitted; the . terminating input may be omitted 
if it would be on the last line of the command list. The open and visual commands are 
permitted in the command list and take input from the terminal. 


The global command itself may not appear in cmds. The undo command is also not permitted 
there, since undo instead can be used to reverse the entire global command. The options 
autoprint and autoindent are inhibited during a global command, (and possibly the trailing / 
delimiter) and the value of the report option is temporarily infinite, in deference to a report 
for the entire global command. Finally, the context mark (’) is set to the value of . before the 
global commands begin and is not changed during a global command, except perhaps by an 
open or visual mode within the global command. 


g! /patlemds abbr: y 

The variant form of a global command runs cmds at each line not matching pat. 
(.) insert abbr: i 
text 


i! 
text 


Places the given text before the specified line. The current line is left at the last line input. If 
there were no lines input it is left at the line before the addressed line. This command differs 
from append only in the placement of text. 


The variant toggles autoindent during the insert. 


(.,.+1) join count flags abbr: j 
Places the text from a specified range of lines together on one line. White space is adjusted at 
each junction to provide at least one blank character, two if there was a . at the end of the 
line, or none if the first following character is a ). If there is already white space at the end of 
the line, the white space at the start of the next line will be discarded. 


The variant causes a simpler join with no white space processing. Characters in the lines are 
simply concatenated. 


() kx 
The k command is a synonym for mark. It does not require a blank or tab before the 
following letter. 


(.,.) list count flags 
Prints the specified lines in a more unambiguous way. Tabs are printed as “I and the end of 
each line is marked with a trailing $. The current line is left at the last line printed. 


map /hs rhs 
The map command is used to define macros for use in visual mode. The /hs should be a single 
character, or the sequence #n (for a digit), referring to function key m. When this character 
or function key is typed in visual mode, it will be as though the corresponding rhs has been 
typed. On terminals without function keys, you can type #n. See section 7.9 for more details. 


(.) mark x 
Gives the specified line mark x, a single lower case letter. The x must be preceded by a blank 
or a tab. The addressing form ’x then addresses this line. The current line is not affected by 
this command. 


(.,.) move addr abbr: m 
The move command repositions the specified lines to be after addr. The first of the moved 
lines becomes the current line. 


next abbr: n 
The next file from the command line argument list is edited. 


n! 
The variant suppresses warnings about the modifications to the buffer not having been written 
out, discarding (irretrievably) any changes which may have been made. 

n filelist 


n +command filelist 
The specified filelist is expanded and the resulting list replaces the current argument list. The 
first file in the new list is then edited. If command is given (it must contain no spaces), then 
it is executed after editing the first such file. 


(.,.) number count flags abbr: # or nu 
Prints each specified line preceded by its buffer line number. The current line is left at the 
last line printed. 


(.) open flags abbr: 0 

(.) open /pat/lags 
Enters intraline editing open mode at each addressed line. If pat is given, then the cursor will 
be placed initially at the beginning of the string matched by the pattern. To exit this mode 


use Q. See sections 1 through 9 for more details.® 


preserve 
The current editor buffer is saved as though the system has just crashed. This command is for 
use only in emergencies when a write command has resulted in an error and you do not know 
how to save your work. After a preserve you should seek help. 


(.,.) print count abbr: p or P 
Prints the specified lines with non-printing characters printed as control characters “x; delete 
(octal 177) is represented as “?. The current line is left at the last line printed. 


(.)put buffer abbr: pu 
Puts back previously deleted or yanked lines. Normally used with delete to effect movement of 
lines, or with yank to effect duplication of lines. If no buffer is specified, then the last deleted 
or yanked text is restored.’ By using a named buffer, text may be restored that was saved 
there at any previous time. 


quit abbr: q 
Causes the ex editor to terminate. No automatic write of the editor buffer to a file is 
performed. However, ex issues a warning message if the file has changed since the last write 
command was issued, and does not quit (the ex editor will also issue a diagnostic if there are 
more files in the argument list). Normally, you will wish to save your changes and you should 
give a write command. If you wish to discard them, use the q! command variant. 


Quits from the editor, discarding changes to the buffer without complaint. 


(.)read file abbr: r 
Places a copy of the text of the given file in the editing buffer after the specified line. If no 
file name is given, the current file name is used. The current file name is not changed unless 
there is none, in which case file becomes the current name. The sensibility restrictions of the 
edit command apply here also. If the file buffer is empty and there is no current name, then 
ex treats this as an edit command. 

Address 0 is legal for this command and causes the file to be read at the beginning of the 
buffer. Statistics are given as for the edit command when the read successfully terminates. 
After a read the current line is the last line read.* 


(.)read !command 
Reads the output of the command command into the buffer after the specified line. This is not 
a variant form of the command, rather a read specifying a command rather than a filename. 
A blank or tab before the ! is mandatory. 


recover file 
Recovers file from the system save area. Used after an accidental hang-up of the phone or a 
system crash° or preserve command, except that when you use preserve you will be notified by 


6. Not available in all V2 editors due to memory constraints. 


7. No modifying commands may intervene between the delete or yank and the put, nor may lines be moved between files 
without using a named buffer. 


8. Within open and visual the current line is set to the first line read rather than the last. 
9. The system saves a copy of the file you are editing only if you have made changes to the file. 
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mail when a file is saved. 


rewind abbr: rew 


rew! 


The argument list is rewound, and the first file in the list is edited. 


Rewinds the argument list discarding any changes made to the current buffer. 


set parameter 


shell 


With no arguments, prints those options whose values have been changed from their defaults; 
with parameter ail it prints all of the option values. 


Giving an option name followed by a ? causes the current value of that option to be printed. 


_The ? is unnecessary unless the option is Boolean valued. Boolean options are given values 


either by the form “set option” to turn them on or “set nooption” to turn them off. String 
and numeric options are assigned via the form “set option=value’’. 


More than one parameter may be given to set; they are interpreted left-to-right. 


abbr: sh 
A new shell is created. When it terminates, editing resumes. 


source file abbr: so 


Reads and executes commands from the specified file. The source commands may be nested. 


(.,.)substitute /pat/repl/options count flags abbr: s 


On each specified line, the first instance of pattern par is replaced by replacement pattern rep. 
If the global indicator option character g appears, then all instances are substituted. If the 
confirm indication character ¢ appears, then before each substitution, the line to be substituted 
is typed with the string to be substituted marked with { characters. By typing a y, one can 
cause the substitution to be performed; any other input causes no change to take place. After 
a substitute command the current line is the last line substituted. 


Lines may be split by substituting newline characters into them. The newline’in rep/ must be 
escaped by preceding it with a \. Other metacharacters available in pat and rep/ are described 
below. 


(.,.) substitute options count flags abbr: s 


If pat and rep! are omitted, then the last substitution is repeated. This is a synonym for the 
& command. 


(.,.) t addr flags 


The t command is a synonym for copy. 


ta tag 


The focus of editing switches to the location of tag, switching to a different line in the current 
file where it is defined, or if necessary to another file. If you have modified the current file 
before giving a tag command, you must write it out; giving another fag command, specifying 
no tag will reuse the previous tag. 


The tag file is normally created by a program such as ctags, and consists of a number of lines 
with three fields separated by blanks or tabs. The first field gives the name of the tag, the 
second the name of the file where the tag resides, and the third gives an addressing form 
which can be used by the editor to find the tab. This field is usually a contextual scan using 


1] 


fpat/ to be immune to minor ‘changes in the file. Such scans are always performed as if 
nomagic was set. 


Names in the tag file must be sorted alphabetically.'° 


unabbreviate word abbr: una 
Delete word from the list of abbreviations. 


undo abbr: u 
Reverses the changes made in the buffer by the last buffer editing command. 


Note: global commands are considered a single command for the purpose of undo (as are open 
and visual). Also, the commands write and edit which interact with the file system cannot be 
undone; undo is its own inverse. 


The undo command always marks the previous value of the current line (.) as ”. After an 
undo command, the current line is the first line restored or the line before the first line deleted 
if no lines were restored. For commands with more global effect such as global and visual the 
current line regains it’s pre-command value after an undo. 


unmap /hs 
The macro expansion associated by map for /hs is removed. 


(1,8) v/pathemds 
A synonym for the global command variant g!, running the specified cmds on each line which 
does not match pat. 


version abbr: ve 
Prints the current version number of the editor as well as the date the editor was last changed. 


(.) visual type count flags abbr: vi 
Enters visual mode at the specified line. The type argument is optional and may be -, f, or . 
as in the z command to specify the placement of the specified line on the screen. By default, 
if type is omitted, the specified line is placed as the first on the screen. A count specifies an 
initial window size; the default is the value of the option window. See sections 1 through 9 
for more details. To exit this mode, type Q. 


visual file 
visual +n file 
From visual mode, this command is the same as edit 


(1,$) write file abbr: w 
Write changes made back to file, printing the number of lines and characters written. 
Normally file is omitted and the text goes back where it came from. If a file is specified, then 
text will be written to that file.!! If the file does not exist it is created. The current file name 
is changed only if there is no current file name; the current line is never changed. 


10. Not available in all V2 editors due to memory constraints. 


11. The editor writes to a file only if it is the current file and is edited, if the file does not exist, or if the file is actually a 
teletype (/devéty, dev/null). Otherwise, you must give the variant form w! to force the write. 
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If an error occurs while writing the current and edited file, the editor considers that there has 
been no write since last change even if the buffer had not previously been modified. 


(1,$) write> > file abbr: w>> Be 


Writes the buffer contents at the end of an existing file. 


w! name 
Overrides the checking of the normal write command and will write to any file which the 
system permits. 


(1,8) w !command 
Writes the specified lines into command. 


Note: There is a difference between w! which overrides checks and w! which writes to a 
command. 


wq name 
Like a write and then a quit command. 


wq! name 
The variant overrides checking on the sensibility of the write command, as w! does. 


xit name 
If any changes have been made and not written, writes the buffer out. Then, in any case, 
quits. 

(.,. yank buffer count abbr: ya 


Places the specified lines in the named buffer, for later retrieval via put. If no buffer name is 
specified, the lines go to a more volatile place (see the put command description). 


(+1) z count 
Print the next count lines (default window). 


(.) z type count 
Prints a window of text with the specified line at the top. If type is - the line is placed at the 
bottom, a . causes the line to be placed in the center. 


Note: Forms z™ and z{ also exist; z™ places the current line in the center, surrounds it with 
lines of - characters, and leaves the current line at this line. The form z{ prints the window 
before z- would. The characters +, f and - may be repeated for cumulative effect. On some 
V2 editors, no type may be given. 


A count gives the number of lines to be displayed rather than double the number specified by 
the scroll option. On a CRT the screen is cleared before display begins unless a count which is 
less than the screen size is given. The current line is left at the last line printed. 


! command 
The remainder of the line after the ! character is sent to a shell to be executed. Within the 
text of command the characters % and # are expanded as in file names, and the ! character is 
replaced with the text of the previous command. Thus, in particular, !! repeats the last such 
shell escape. If any such expansion is performed, the expanded line will be echoed. The 
current line is unchanged by this command. 


If there has been “‘no write” of the buffer contents since the last change to the editing buffer, 
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then as a warning, a diagnostic message will be printed before the command is executed. A 
single ! is printed when the command completes. 


(addr, addr) ! command 
Takes the specified address range and supplies it as standard input to command. The resulting 
output then replaces the input lines. 


($) = 
Prints the line number of the addressed line. The current line is unchanged. 


(.,.) > count flags 

(.,.) < count flags 
Perform intelligent shifting on the specified lines: < shifts left and > shifts right. The 
quantity of shift is determined by the shiftwidth option and the repetition of the specification 
character. Only white space (blanks and tabs) is shifted. No non-white characters are 
discarded in a left-shift. The current line becomes the last line which changed due to the 
shifting. 


An end-of-file from a terminal input scrolls through the file. The scro// option specifies the 
size of the scroll, normally a half screen of text. 

(.+1,.4+1) 

(.+1,.+1)| 
An address alone causes the addressed lines to be printed. A blank line prints the next line in 
the file. 


(.,.) & options count flags 
Repeats the previous substitute command. 


(.,.) ~ options count flags 
Replaces the previous regular expression with the previous replacement pattern from a 
substitution. 


8. Regular Expressions and Substitute Replacement Patterns 
8.1 Regular Expressions 


A regular expression specifies a set of strings of characters. A member of this set of strings is 
said to be matched by the regular expression. The ex editor remembers two previous regular 
expressions: the previous regular expression used in a substitute command and the previous regular 
expression used elsewhere (referred to as the previous scanning regular expression). The previous 
regular expression can always be referred to by a null re (// or ??). 


8.2 Magic and Nomagic 


The regular expressions allowed by the ex editor are constructed in one of two ways depending 
on the setting of the magic option. The ex and vi editor default setting of magic gives quick access 
to a powerful set of regular expression metacharacters. The disadvantage of magic is that the user 
must remember that these metacharacters are magic and precede them with the character \ to use 
them as “ordinary” characters. With nomagic, regular expressions are much simpler, there being 
only two metacharacters. The power of the other metacharacters is still available by preceding the 
(now) ordinary character with a \. 


Note: \ is always a metacharacter. 
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The remainder of the discussion of regular expressions assumes that the setting of this option is 
-, 12 
magic. 


8.3 Basic regular expression summary 
The following basic constructs are used to construct magic mode regular expressions. 


char An ordinary character matches itself. The characters t at the beginning of a line, $ at 
the end of line, * as any character other than the first, ., \, [, and ~ are not ordinary 
characters and must be escaped (preceded) by \ to be treated as such. 


if At the beginning of a pattern forces the match to succeed only at the beginning of a 
line. 

$ At the end of a regular expression forces the match to succeed only at the end of the 
line. 

ries Matches any single character except the newline character. 

\< Forces a match to occur only at the beginning of a variable or word; i.e., either at the 


beginning of a line, or just before a letter, digit, or underline and after a character which 
is not one of these. 


\= ’ Forces a match to occur only at the end of a variable or word, i.e., either the end of the 
line or before a character which is neither a letter, a digit, nor the underline character. 


[string] | Matches any single character in the class defined by string. Most characters in string 
define themselves. A pair of characters separated by - in string defines the set of 
characters collating between the specified lower and upper bounds, thus [a-z] as a 
regular expression matches any single lower-case letter. If the first character of string is 
an f{ then the construct matches those characters which it otherwise would not; thus 
[ta-z] matches anything but a lower-case letter (and of course a newline character). To 
place any of the characters {, [, or - in string you must escape them with a preceding \. 


8.4 Combining Regular Expression Primitives 


The concatenation of two regular expressions matches the leftmost and then longest string which 
can be divided, with the first piece matching the first regular expression and the second piece 
matching the second. Any of the (single-character matching) regular expressions mentioned above 
may be followed by the character * to form a regular expression which matches any number of 
adjacent occurrences (including 0) of characters matched by the regular expression it follows. 


The character ~ may be used in a regular expression and matches the text which defined the 
replacement part of the last substitute command. A regular expression may be enclosed between the 
sequences \( and \) with side effects in the substitute replacement patterns. 


8.5 Substitute Replacement Patterns 


The basic metacharacters for the replacement pattern are & and ~; these are given as \& and \" 
when nomagic is set. Each instance of & is replaced by the characters which the regular expression 
matched. The metacharacter ~ stands (in the replacement pattern) for the defining text of the 
previous replacement pattern. 


Other metasequences possible in the replacement pattern are always introduced by the escape 
character \. The sequence \n is replaced by the text matched by the nth regular subexpression 


12. To discern what is true with nomagic it suffices to remember that the only special characters in this case will be | at the 
beginning of a regular expression, § at the end of a regular expression, and \. With nomagic the characters “ and & also 
lose their special meanings to the replacement pattern of a substitute. 
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enclosed between \( and \).'? The sequences \u and \I cause the immediately following character in 
the replacement to be converted to upper case or lower case, respectively, if this character is a letter. 
The sequences \U and \L turn such conversion on, either until \E or \e is encountered or until the 
end of the replacement pattern. 


9. Option Descriptions 


autoindent, ai default: noai 
Can be used to ease the preparation of structured program text. At the beginning of each 
append, change, or insert command or when a new line is opened or created by an append, 
change, insert, or substitute operation within the open or visual mode, ex looks at the line 
being appended after, the first line changed, or the line inserted before and calculates the 
amount of white space at the start of the line. It then aligns the cursor at the level of 
indentation so determined. 


If the user then types in lines of text, the lines will continue to be justified at the displayed 
indenting level. If more white space is typed at the beginning of a line, the following line will 
start aligned with the first non-white character of the previous line. To back the cursor to the 
preceding tabstop one can hit “D. The tabstops (going backwards) are defined as multiples of 
the shiftwidth option. You cannot backspace over the indent, except by sending an end-of-file 
with a “D. 


Specially processed in this mode is a line with no character added to it, which turns into a 
completely blank line (the white space provided for the autoindent is discarded). Also 
specially processed in this mode are lines beginning with an f and immediately followed by a 
“D. This causes the input to be repositioned at the beginning of the line while retaining the 
previous indent for the next line. Similarly, a 0 followed by a “D repositions at the beginning 
without retaining the previous indent. 


The autoindent option does not happen in global commands or when the input is not a 
terminal. 


autoprint,ap default: ap 
Causes the current line to be printed after each delete, copy, join, move, substitute, t, undo or 
shift command. This has the same effect as supplying a trailing p to each such command. 
The autoprint is suppressed in globals, and only applies to the last of many commands on a 
line. 


autowrite,aw default: noaw 
Causes the contents of the buffer to be written to the current file if you have modified it and 
gives a next, rewind, tab, or ! command, or a “{ (switch files) or “] (tag goto) command in 
visual. 


Note: The command does not autowrite. In each case, there is an equivalent way of switching 
when the autowrite option is set to avoid the autowrite (ex for next, rewind! for rewind, tag! 
for tag, shell for !, and :e # and a :ta! command from within visual). 


beautify, bf default: nobeautify 
Causes all control characters except tab, newline, and form-feed to be discarded from the 


13. When nested, parenthesized subexpressions are present, m is determined by counting occurrences of \( starting from the 
left. 
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input. A complaint is registered the first time a backspace character is discarded. The 
beautify option does not apply to command input. 


directory, dir default: dir=/tmp 
Specifies the directory in which ex places its buffer file. If this directory in not writable, then 
the editor will exit abruptly when it fails to be able to create its buffer there. 


edcompatible default: noedcompatible 
Causes the presence or absence of g and c suffixes on substitute commands to be remembered 
and to be toggled by repeating the suffices. The suffix r makes the substitution be as in the ~ 
command, instead of like, & .!4 


errorbells,eb default: noeb 
Error messages are preceded by a bell.!° If possible the editor always places the error message 
in a standout mode of the terminal (such as inverse video) instead of ringing the bell. 


hardtabs, ht default: ht=8 
Gives the boundaries on which terminal hardware tabs are set (or on which the system 
expands tabs). 


ignorecase,ic default: noic 
All upper case characters in the text are mapped to lower case in regular expression matching. 
In addition, all upper case characters in regular expressions are mapped to lower case except 
in character class specifications. 


lisp default: nolisp 
The autoindent option indents appropriately for lisp code, and the (), {}, [l, and ]] commands 
in open and visual modes are modified to have meaning for /isp. 


list default: nolist 
All printed lines will be displayed more unambiguously, showing tabs and end-of-lines as in 
the list command. 


magic default: magic for ex and vi \ 
If nomagic is set, the number of regular expression metacharacters is greatly reduced, with 
only { and $ having special effects. In addition the metacharacters ~ and & of the 
replacement pattern are treated as normal characters. All the normal metacharacters may be 
made magic when nomagic is set by preceding them with a \,. 


mesg default: mesg 
Causes write permission to be turned off to the terminal while you are in visual mode, if 
nomesg is set.'® 


number,nu default: nonumber 
Causes all output lines to be printed with line numbers. In addition each input line will be 
prompted for by supplying the line number it will have. 


14, Version 3 only. 
15. Bell ringing in open and visual mode on errors is not suppressed by setting noeb. 
16, Version 3 only. 
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open default: open 
If noopen, the commands open and visual are not permitted. 


optimize, opt default: optimize 
Throughput of text is expedited by setting the terminal not to do automatic carriage returns 
when printing more than one (logical) line of output, greatly speeding output on terminals 
without addressable cursors when text with leading white space is printed. 


paragraphs, para default: para=IPLPPPQPP Libp 
Specifies the paragraphs for the { and } operations in open and visual. The pairs of characters 
in the option’s value are the names of the macros which start paragraphs. 


prompt default: prompt 
Command mode input is prompted for with a colon (:). 


redraw default: noredraw 
The editor simulates (using great amounts of output) an intelligent terminal on a dumb 
terminal (e.g., during insertions in visual the characters to the right of the cursor position are 
refreshed as each input character is typed). This option is useful only at very high speed. 


remap default: remap 
If on, macros are repeatedly tried until they are unchanged.!’ For example, if o is mapped to 
O, and O is mapped to I, then if remap is set, o will map to I, but if noremap is set, it will 
map to O. 


report default: report™5 
Specifies a threshold for feedback from commands. Any command which modifies more than 
the specified number of lines will provide feedback as to the scope of its changes. For 
commands such as global, open, undo, and visual, which have potentially more far-reaching 
scope, the net change in the number of lines in the buffer is presented at the end of the 
command, subject to this same threshold. Thus, notification is suppressed during a global 
command on the individual commands performed. 


scroll default: scroll=% window 
Determines the number of logical lines scrolled when an end-of-file is received from a terminal 
input in command mode and the number of lines printed by a command mode z command 
(double the value of scroll). 


sections default: sections=SHNHH HU 
Specifies the section macros for the [[ and ]] operations in open and visual. The pairs of 
characters in the option’s value are the names of the macros which start paragraphs. 


shell, sh default: sh™/bin/sh 
Gives the pathname of the shell forked for the shell escape command !, and by the shell 
command. The default is taken from SHELL in the environment, if present. 


shiftwidth, sw default: sw=8 


Gives the width a software tabstop used in reverse tabbing with “D when using autoindent to 
append text, and by the shift commands. 


17. Version 3 only. 


showmatch, sm default: nosm 
In open and visual mode, when a ) or } is typed, moves the cursor to the matching ( or { for 
one second if this matching character is on the screen. Extremely useful with disp. 


slowopen, slow terminal dependent 
Affects the display algorithm used in visual mode, holding off display updating during input of 
new text to improve throughput when the terminal in use is both slow and unintelligent. 


tabstop, ts default: ts™8 
The editor expands tabs in the input file to be on tabstop boundaries for the purposes of 
display. 

taglength, tl default: tl=0 


‘Tags are not significant beyond this many characters. A value of zero (the default) means 
that all characters are significant. 


tags default: tags™tags/usr/lib/tags 
A path of files to be used as tag files for the tag command.'* A requested tag is searched for 
in the specified files, sequentially. By default, files called tags are searched for in the current 
directory and in /usr/lib (a master file for the entire system). 


term from environment TERM 
The terminal type of the output device. 


terse default: noterse 
Shorter error diagnostics are produced for the experienced user. 


warn default: warn 
Warn if there has been “[No write since last change)” before a ! command escape. 


window default: window™speed dependent 
The number of lines in a text window in the visual command. The default is 8 at slow speeds 
(600 baud or less), 16 at medium speed (1200 baud), and the full screen (minus one line) at 
higher speeds. 


w300, w1200, w9600 
These are not true options but set window only if the speed is slow (300), medium (1200), or 
high (9600), respectively. They are suitable for an EXINIT and make it easy to change the 
8/16/full screen rule. 


wrapscan, ws default: ws 
Searches that use regular expressions in addressing will wrap around past the end of the file. 


wrapmargin, wm default: wm==0 
Defines a margin for automatic wrapover of text during input in open and visual modes. 


writeany, wa default: nowa 


Inhibit checks normally made before write commands, allowing a write to any file which the 
system protection mechanism will allow. 


18. Version 3 only. 
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10. Limitations 


Editor limits that the user is likely to encounter are as follows: 1024 characters per line, 256 
characters per global command list, 128 characters per file name, 128 characters in the previous 
inserted and deleted text in open or visual, 100 characters in a shell escape command, 63 characters 
in a string valued option, and 30 characters in a tag name, and a limit of 250,000 lines if the file is 
silently enforced. 


The visua/ implementation limits to 32 the number of macros defined with map, and the total 
number of characters in macros to be less than 512. 


